home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 5 / BBS in a Box -Volume V (BBS in a Box) (April 1992).iso / Files / Tele / Q / Quoter.cpt / About Quoter… next >
Encoding:
Text File  |  1990-01-06  |  6.4 KB  |  127 lines  |  [TEXT/MWII]
  1.                            About Quoter…
  2.  
  3. Quoter is a White Knight 11.x RCMD designed to insert a writer's name or
  4. initials at the start of every line of text copied to the Clipboard,
  5. just like those Fido guys do it. This text can then be pasted back to WK
  6. to show authorship of the original quotation. For instance, if this
  7. block of text were a message by myself, I could select it in White
  8. Knight, copy it to the Clipboard, tell Quoter to use the initials PJ and
  9. paste the following back to WK:
  10.  
  11. PJ> Quoter is a White Knight 11.x RCMD designed to insert a writer's
  12. PJ> name or initials at the start of every line of text copied to the
  13. PJ> Clipboard, just like those Fido guys do it. This text can then be
  14. PJ> pasted back to WK to show authorship of the original quotation.
  15. PJ> For instance, if this block of text were a message by myself, I
  16. PJ> could select it in White Knight, copy it to the Clipboard, tell
  17. PJ> Quoter to use the initials PJ and paste the following back to WK:
  18.  
  19. If White Knight variable F1 = 0 or F1 = 2, then Quoter automatically
  20. reflows text to match whatever line length limit you enter into the WK
  21. variable L1%.
  22.  
  23. A sample commented Procedure file using Quoter (which has a RCMD ID of
  24. 250) looks like this:
  25.  
  26. ( ------------------------------------------------------------------- )
  27. (                                                                     )
  28. (                            Quoter 1.1                               )
  29. (            An RCMD for White Knight 11 by Pete Johnson              )
  30. (                                                                     )
  31. ( Use: select text to be quoted, copy it to the Clipboard and run     )
  32. ( Quoter. Tell Quoter what name or initials to use as the quoting     )
  33. ( source and hit return or click OK. Quoter will prepend the initials )
  34. ( you entered to every line of selected text.                         )
  35. (                                                                     )
  36. ( Version 1.1 of Quoter works in one of three modes, determined by    )
  37. ( the value of F1:                                                    )
  38. (                                                                     )
  39. ( If F1 = 0, then Quoter will reformat as necessary to preserve a     )
  40. ( maximum line length of L1 characters. Lines beginning with spaces,  )
  41. ( periods,tabs, colons and semicolons are presumed to have special    )
  42. ( formatting and are left intact except for the insertion of the      )
  43. ( quoting identifier at the start of each line.                       )
  44. (                                                                     )
  45. ( If F1 = 1, Quoter will insert the quoting identifier, otherwise     )
  46. ( preserving the original format.                                     )
  47. (                                                                     )
  48. ( If F1 = 2, Quoter will reformat as necessary to preserve a maximum  )
  49. ( line length of L1 characters, regardless of leading spaces or other )
  50. ( special characters. This is a "less smart" version of mode 0.       )
  51. (                                                                     )
  52. ( Read "About Quoter…" for more info.                                 )
  53.  
  54. LET EQUAL F1%,0
  55.  
  56. ( Variable L1 contains the value for maximum line length to output if )
  57. ( F1 = 0 or F1 = 2, otherwise L1 is ignored and the BBS must handle   )
  58. ( lines which are too long.                                           )
  59.  
  60. LET EQUAL L1%,72
  61.  
  62. ( String P1 contains the prompt character used after the initials or  )
  63. ( name you specify. Note that it should contain at least one space at )
  64. ( its end to separate it from the quoted matter.                      )
  65.  
  66. COPYINTO P1$,> 
  67.  
  68. ( The 1 in the next command tells White Knight to leave its windows   )
  69. ( intact -- Quoter just uses a modal dialog. The 250 is the resource  )
  70. ( ID of the Quoter RCMD, which is embedded in this text file.         )
  71.  
  72. RCMD 1,250
  73.  
  74. ( ------------------------------------------------------------------- )
  75.  
  76.                           Bugs and/or Features
  77.  
  78. In its F1 = 0 mode, Quoter is now mildly sensitive to text formatting.
  79. It respects two carriage returns in a row as an "empty" line, to which
  80. it prepends the entered name or initials. If a line begins with a space,
  81. tab, period, colon or semicolon, Quoter assumes that it's specially
  82. formatted and doesn't modify it, apart from inserting quoting initials.
  83.  
  84. If you don't want to be so delicate, the F1 = 2 mode is for you. It's
  85. identical to the F1 = 0 mode, but it gobbles up leading indentation.
  86.  
  87. If you want to quote a passage with short lines intact, try Quoter in
  88. its F1 = 1 mode. This tells Quoter to simply insert the name or initials
  89. before each line of the text on the Clipboard without additional
  90. formatting. In this case, if a line exceeds the maximum line length
  91. allowed on the BBS where you're posting the message, you may get some
  92. ugly breaks, but if the lines are short this will work fine.
  93.  
  94. If this these options seem useful, you might want to compile several
  95. versions of Quoter: Quoter F.PROC for most formatting, Quoter I.PROC for
  96. the insert mode and Quoter S.PROC for the "squish" mode. The mode you're
  97. in is displayed in Quoter's dialog box: Format means that text will be
  98. reflowed; Insert means that formatting will be preserved; Squish means
  99. that text will be reflowed regardless of leading spaces or special
  100. characters.
  101.  
  102. In complicated instances, you may need to do some formatting by "hand",
  103. or on a line by line basis with Quoter. You can also use Quoter on short
  104. selected passages when you want to mix quotes from different sources
  105. (though Quoter can handle quotes of up to 32,000 characters).
  106.  
  107. Whit Knight string P1$ holds the prompt character which is appended to
  108. the name or initials you enter in the Quoter dialog box. Most quoters
  109. that I've seen use the '>' character followed by one or more spaces to
  110. identify quotes, and this is the way I've set Quoter up in its procedure
  111. file. You can customize this -- adding more spaces or altering the >
  112. character to something else -- by changing the value of P1$ in the
  113. procedure.
  114.  
  115. If all of these options are more trouble than you want to take, don't
  116. worry. The included procedure file sets Quoter up in I believe is its
  117. most useful form.
  118.  
  119. Quoter is free, though I adamantly retain copyright to it and prohibit
  120. anyone using it in a "for sale" package without my explicit permission.
  121. Many thanks to Bob Daniel and Doug Acker for making public an RCMD
  122. shell program, which I used. And thanks to Scott Watson for enabling
  123. RCMDs in White Knight.
  124.  
  125.                        Pete Johnson
  126.                        Nov. 16, 1989
  127.